home *** CD-ROM | disk | FTP | other *** search
/ Games of Daze / Infomagic - Games of Daze (Summer 1995) (Disc 1 of 2).iso / x2ftp / msdos / utils / spriv101 / spriv100.doc < prev   
Text File  |  1994-12-13  |  19KB  |  297 lines
  1. ┌─────────────────────────────────────────────────────────────────────────────┐
  2. │                       SPRITER V1.01 Beta                                    │
  3. └─────────────────────────────────────────────────────────────────────────────┘
  4. ╔═════════════════════════════════════════════════════════════════════════════╗
  5. ║ Spriter Manual By Dimitri Smits, author of SPRITER                    01/06 ║
  6. ╚═════════════════════════════════════════════════════════════════════════════╝
  7.  
  8. TABEL OF CONTENTS                                                            01
  9. Disclaimer ................................................................. 02
  10. Why? ....................................................................... 02
  11. What this proggy does ...................................................... 03
  12. FeedBackWare? What's that? ................................................. 04
  13. BugReports (Please help me to improve) ;) .................................. 04
  14. How to get in touch with the author ........................................ 05
  15. Insecabilis, never heard of (you should be ashamed ;)), who are they? ...... 05
  16. What to expect in future versions .......................................... 05
  17. Credits .................................................................... 06
  18. IGA - Format ............................................................... 06
  19.  
  20. ╔═════════════════════════════════════════════════════════════════════════════╗
  21. ║ Spriter Manual By Dimitri Smits, author of SPRITER                    02/06 ║
  22. ╚═════════════════════════════════════════════════════════════════════════════╝
  23. ╔═════════════════════════════════════════════════════════════════════════════╗
  24. ║ Disclaimer (Sorry, but this is necessary!)                                  ║
  25. ╚═════════════════════════════════════════════════════════════════════════════╝
  26.         The author of this program is not liable for any damage to the
  27.         computer on which this programm will run or has run, nor for any loss
  28.         of DATA whatsoever. The author claims not to have put in any Virusses
  29.         ,Worms, Trojans, or anything else damaging or threatening your compu.
  30.         When this program was first released, it did NOT have anything in it
  31.         (except for drawing routines, mouse routines, and input/output routines
  32.         for managing files).If you have any trouble whatsoever with the program
  33.         you may report it to me, but you MUST remember that the program was
  34.         provided AS IS! Maybe (IF its a bug in the program) I will look after
  35.         it. If You DON'T like this, then DELETE EVERYTHING NOW!
  36.  
  37. ╔═════════════════════════════════════════════════════════════════════════════╗
  38. ║ Why?                                                                        ║
  39. ╚════╤══════╤═════════════════════════════════════════════════════════════════╝
  40.      └┐ Why?└┐ Well I started programming last Mai,(in pure TP 7.0 of course)
  41.       └──────┘ and wanted to create something 'BIG'. Since I had started, all
  42.         of my proggy's stayed under 10K source (when you know that TP compiles
  43.         5K anyhow, you might know that those proggy's wheren't that awesome
  44.         at all ;)), so I thought that I should do something BIG and worthwhile
  45.         (on how to code proggy's in TPascal), yet interesting and pulicly
  46.         appealing. Since there are MANY, MANY ;) trackers available, I figured
  47.         that the world wasn't waiting for another MOD-proggy (with respect
  48.         to all other existing sound-module formats around) and therefore I
  49.         wanted to make something about graphics (the real reason is that I
  50.         don't understand SH*T about music) and then I started wondering about
  51.         what subject ... and came up with a program that could generate an
  52.         array of bytes for screen purposes (more commonly known as sprites &
  53.         fonts) because I wondered where the people on the DEMOScene got there
  54.         marvellous fonts & drawings (I know now (when I'm (or was) writing
  55.         this text) that the use PCX-files or BMP's or GIF's or ...) and
  56.         started meditating on how to accomplish that and what other features
  57.         there would have to be to distinguish it from other drawing-programms
  58.         and came up with an ICONdraw-routine. Well, since then I have learned
  59.         a bit of assembler (a lot actually, but not enough to go fully ASM)
  60.         which I implemented in some routines. This program is not the fastest
  61.         smallest, low in memory use, best coolest proggy ever, but I like my
  62.         first real program and will continue on making it better and optimizing
  63.         the code, as soon I see that there is need to continue.
  64.         The (only) reason why I don't release my sourcecode is that I am a
  65.         bit ashamed by the way it looks, its unoptimizedness (or something like
  66.         that, I know:bad english :)), it being undocumented and hard to follow
  67.         as anyone could expect for a first release of a source of 64K.
  68.         So don't worry, I'm working on a new project now and am rewriting a
  69.         big part of the program. If you want to know what the project is, read
  70.         on in What to expect in future versions.
  71.  
  72. ╔═════════════════════════════════════════════════════════════════════════════╗
  73. ║ Spriter Manual By Dimitri Smits, author of SPRITER                    03/06 ║
  74. ╚═════════════════════════════════════════════════════════════════════════════╝
  75. ╔═════════════════════════════════════════════════════════════════════════════╗
  76. ║ What this proggy does   (or is supposed to do)                              ║
  77. ╚═════════════════════════════════════════════════════════════════════════════╝
  78.         It's a drawing proggy to draw sprites,fonts(libs of sprites) & ICONs.
  79.         It also produces files in I(nsecabilis)G(raphics)A(rray)-format.
  80.         It is not my intention to give a complete overview of it's functions,
  81.         because I have to get up early tomorrow, but here is an explanation
  82.         about getting started:
  83.  
  84. ┌A────────────────────────────┐ ┌B────────────┐ ┌C──────────────────────────┐
  85. │                             │ │  32 * 32    │ │       CREDIT TO ME        │
  86. │      32 * 32 raster         │ │   pixels    │ │            +              │
  87. │                             │ │ the result  │ │    TITLE PROGRAM & VERS   │
  88. │                             │ │ in mode 13H │ ├S───────────┬T─────────────┤
  89. │      Here you draw your     │ │ 320*200*256 │ │IN-FileName │Out-FileName  │
  90. │         pictures            │ └─┬U─┬─┬V─┬───┘ └────────────┴──────────────┘
  91. │                             │ ┌D└──┴─┴──┴─────────────────────────────────┐
  92. │                             │ │ Message Box                               │
  93. │                             │ │                                           │
  94. │                             │ │ ┌───────────────────────────────────────┐ │
  95. │                             │ │ └─Path──────────────────────────────────┘ │
  96. └─────────────────────────────┘ └───────────────────────────────────────────┘
  97. ┌E─────┬F─────┐   ┌N┐ ┌O───────────────────────────────────┐┌P──────────────┐
  98. │ SAVE │ LOAD │BAR├─┤ │                                    ││               │
  99. ├G─────┼H─────┤   │ │ │        256 COLORS                  │├Q──────────────┤
  100. │ QUIT │ SIZE │   │ │ │                                    ││               │
  101. └──────┴──────┘┌M─│ │ │                                    │├───────────────┤
  102.   Actual Pict >│NR│ │ │                                    ││               │
  103. ┌I─────┬J─────┐└──┤ │ │                                    ││ SAVE INFO     │
  104. │CLEAR │ COPY │   │ │ │                                    ││               │
  105. ├K─────┼L─────┤   │ │ │                                    │├R──────────────┤
  106. │PASTE │ CUT  │   ├─┤ │                                    ││               │
  107. └──────┴──────┘   └N┘ └────────────────────────────────────┘└───────────────┘
  108.  
  109. A => A 32*32 (4pixel*4pixel)-raster in which you can draw your sprites
  110.      leftbutton=U, rightbutton=V, middlebutton=0 (erase)
  111. B => along with A, you get to see the result Real-Size
  112. C => just filling
  113. D => here is where you get to see errors (Disk I/O (file not found, ...))
  114.      also there is a bar with a path-string, which you can alter
  115. E => this saves according to the T extension in IGA-format or ICO-format
  116.      if the extension is IGA, the program will use P,Q,R to know what to save
  117.      so, when you want to save something, FIRST check if the settings in P,Q,R
  118.      are the ones you would like to use for your saving.
  119. F => this LOADs into memory from the Picture you are on (M) onwards 'til
  120.      everything is loaded (when you load a lib from a position, but when the
  121.      lib contains more than 60-M, it will start at the beginning again (M=1)
  122.      when it reaches 61)
  123. G => Obvious not?!?
  124. H => has only effect on P and Q variables
  125. I => clears current picture defined by M
  126. J => makes a copy of everything in the P & Q variables to a clipboard
  127. K => gets the clipboard to the current picture and fills it from X1 Y1, defined
  128.      in P & Q
  129. L => Cuts everything within the range of the P & Q variables
  130.  
  131. ╔═════════════════════════════════════════════════════════════════════════════╗
  132. ║ Spriter Manual By Dimitri Smits, author of SPRITER                    04/06 ║
  133. ╚═════════════════════════════════════════════════════════════════════════════╝
  134. M => points to current position,by leftclicking the mouse on it, you can change
  135.      directly to a specified picture (which will alter A & B as well)
  136. N => 2 arrows used by clicking on it to alter the position in picture array
  137.      indirectly changes M and thus A & B also
  138.      leftclick=1 at a time, rightclick=keep pressed to alter till you artive
  139.      where you want to be
  140. O => colours of palette,which is available
  141.      leftclicking on them will alter U
  142.      rightclicking on them will alter V
  143.      remember that when you want to change an ICON, you MAY ONLY USE colors
  144.      0 TO 15 (line 1 in O)
  145. P & Q => topleft till bottomright + X-axis & Y-axis length to (cut,copy,...)
  146. R => from which picture till which picture to save
  147. S => name inputfile
  148. T => name outputfile
  149. U => color left
  150. V => color right
  151.  
  152. ╔═════════════════════════════════════════════════════════════════════════════╗
  153. ║ FeedBackWare? What is that?                                                 ║
  154. ╚═════════════════════════════════════════════════════════════════════════════╝
  155.         It's a name I gave this 'system' of Public Domain I use.
  156. When you want to use this program, you will get my permission, but what you
  157. will have to do is put EVERYTHING you made using this program on the PUBLIC
  158. DOMAIN. Also, I want YOU to send me an E-Mail to my Internet address(see below)
  159. (now I'll finally get some mail!) in which you will give me an idea of what
  160. you think about SPRITER, and also on which Internet (FTP-site) I will be able
  161. to find your GFX and how to get there.
  162. If you have any comments or bugreports or ideas or ...,whatever,please send it
  163. to me, I'll try to respond as soon as possible.
  164.         So, in a nutshell: FeedBackWare is:
  165. You Download SPRITER, which you may use and copy IF:
  166.         - YOU send me E-Mail
  167.         - YOU notice me where/how I can find your work with my program
  168.         - You send me MONEY, WOMEN, A PENTIUM, ..... ;) (if you feel like it)
  169.         - You give me some feedback on the proggy, so it will become better
  170.         - You put your work on the public domain
  171.         - When you use any of these GFX for a production, please give credit
  172.           to me (Dimitri Smits or Discordis / Insecabilis) and the artist
  173.           who made the library.
  174. If your work is GOOD, it will be included in a next version of SPRITER with
  175. credits to your work.
  176. If your tips prove usefull, you are also on the road to fame, because you
  177. will be mentioned hardcoded in the proggy.
  178.  
  179. ╔═════════════════════════════════════════════════════════════════════════════╗
  180. ║ Bugreports                                                                  ║
  181. ╚═════════════════════════════════════════════════════════════════════════════╝
  182.         - When you type in a name, (especially path) its quite possible that
  183.         you see as if nothing happened , well it probably didn't
  184.         - I dont get the right palette for the ICONS ( so if you know, send it
  185.       to me, please!)
  186.         - after altering anything in R, the red Square is gone
  187.     - program uses KeybScancodes -> the character displayed may be or not
  188.       be the one you expected to type, so watch out what you type
  189.       (this will be fixed in the next release)
  190. Maybe (read: probably) these will be fixed in another version
  191.  
  192. ╔═════════════════════════════════════════════════════════════════════════════╗
  193. ║ Spriter Manual By Dimitri Smits, author of SPRITER                    05/06 ║
  194. ╚═════════════════════════════════════════════════════════════════════════════╝
  195. ╔═════════════════════════════════════════════════════════════════════════════╗
  196. ║ How to get in touch with the author?                                        ║
  197. ╚═════════════════════════════════════════════════════════════════════════════╝
  198. About Spriter
  199. Via E-Mail:
  200.         Internet:
  201.                send to: dsmits@zorro.ruca.ua.ac.be
  202.                                 ^^^-> hey,don't lauch, I didn't choose its name
  203.            if about spriter       subscribe: Discordis.IGA
  204.            anything else (e.g. application for GFX artist)
  205.                         subscribe: INSECABILIS
  206.  
  207. Via Snail Mail:
  208.         send to: Discordis/Insecabilis
  209.                  Paulus Beyestraat 91
  210.                  2100 Deurne (BELGIUM)
  211.  
  212. ╔═════════════════════════════════════════════════════════════════════════════╗
  213. ║ Insecabilis? Never heard of! Who are they?                                  ║
  214. ╚═════════════════════════════════════════════════════════════════════════════╝
  215.         Insecabilis is the name of a Demo/Intro/Game group I am trying to
  216.         start. At the moment of this writing, there are 3 members
  217.                 Dimitri Smits (Discordis): CODER
  218.                 Benjamin De Hondt        : MUSICIAN (has his own CD out in a
  219.                                            couple of months)
  220.                 Ben Verpoorten           : CODER
  221.  
  222.         If YOU are intersted in 'working' for a group such as ours, please
  223.         contact me, I won't lauch (I'd probably do worse anyway).
  224.         So, if you are a 'GOOD' GFX-artist, a 'GOOD' musician or a 'GOOD'
  225.         CODER (preferably capable of writing his Sourcecode in TP7.0(with
  226.         ASM-based subroutines) and able to create a musicsystem for 8CHN
  227.         MODS(or something)) PLEASE send us some of your work, or tell us
  228.         where to find it (on Internet) and we 'll take a look at it.
  229.         We are (at least not for now) not yet into commercial demos, becoz
  230.         we want to learn to code better and have more efficiency first,
  231.         maybe we will in a 'near' FUTURE.
  232.  
  233. ╔════════════════════════════════════════════════════════════════════════════╗
  234. ║ What to expect in future releases                                          ║
  235. ╚════════════════════════════════════════════════════════════════════════════╝
  236.         - more than 32 * 32 piccy's
  237.         - more than 60 piccy's
  238.         - a paletteroutine for getting better control over what you draw
  239.         - a text-font editor (draw binary fonts for in text mode)
  240.                 (how to implement that, will be explained then)
  241.         - faster routines
  242.         - full TP7.0 *.PAS sourcecode (no TPU's -> .PAS) with documentation
  243.         - examples
  244.         - fileselection routines (you wouldn't have to know where,what file is)
  245.         - many, many more things
  246.         - if you have any ideas, get in touch I'll add them to this list
  247.           and will implement them sooner or later.
  248.     - another palette possible (boy, everyone hates green nowadays!;)
  249.  
  250. ╔═════════════════════════════════════════════════════════════════════════════╗
  251. ║ Spriter Manual By Dimitri Smits, author of SPRITER                    06/06 ║
  252. ╚═════════════════════════════════════════════════════════════════════════════╝
  253. ╔═════════════════════════════════════════════════════════════════════════════╗
  254. ║ Credits                                                                     ║
  255. ╚═════════════════════════════════════════════════════════════════════════════╝
  256. Dimitri Smits for coding & ideas
  257. Benjamin De Hondt for Beta-testing
  258. Steven Smits for Beat-testing
  259. Ellen Smits for Beta testing
  260. Guy Hofkens for Mouse-Routines (Partially)
  261. Dirk Schippers /A.P.E.X. for giving me ideas and learning me to program
  262.   WITHOUT BGI's and a beginning of ASM-coding (implemented in TP)
  263. ...
  264.  
  265. ╔═════════════════════════════════════════════════════════════════════════════╗
  266. ║ IGA-Format                                                                  ║
  267. ╚═════════════════════════════════════════════════════════════════════════════╝
  268.       ┌ BYTE ─┬──────── DESCRIPTION ───────────────────────────────────┐
  269.       │1 to 3 │ IGA (header)                                           │
  270.       ├───────┼────────────────────────────────────────────────────────┤
  271.       │   4   │ Version this file was made with                        │
  272.       ├───────┼────────────────────────────────────────────────────────┤
  273.       │   5   │ number of piccy's in FILE                              │
  274.       ├───────┼────────────────────────────────────────────────────────┤
  275.       │   6   │ Y-axis of each piccy (set for all)                     │
  276.       ├───────┼────────────────────────────────────────────────────────┤
  277.       │   7   │ X-axis of each piccy (set for all)                     │
  278.       ├───────┼────────────────────────────────────────────────────────┤
  279.       │   8   │ number times (y times (x pixels))                      │
  280.       .   .   .                                                        .
  281.       .   .   .                                                        .
  282.       └────────────────────────────────────────────────────────────────┘
  283.  
  284. ╔═════════════════════════════════════════════════════════════════════════════╗
  285. ║ Last Minute Note                                                            ║
  286. ╚═════════════════════════════════════════════════════════════════════════════╝
  287.    This Package should be spread totally, without changes, and should contain
  288.    the following files:        
  289.     SPRIV100.DOC  you are reading this
  290.         SPRIHIST.INS  history file
  291.         SPRITER.DAT   DATA-file for SPRITER
  292.         SPRITER.EXE   SPRITER, the executable
  293.         FILE_ID.DIZ   description-file
  294.     PALETTE.PAL   palette-file (if you make another palette, this won't
  295.               change the palette in the program, but if your palette
  296.               is better, you may always send it in)
  297.